home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / fret_100.zip / FERRET.DOC < prev    next >
Text File  |  1992-04-20  |  21KB  |  721 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.           █████████ █████████ █████████ █████████ █████████ █████████
  23.          ░██░░░░░░ ░██░░░░░░ ░██░░░░░██░██░░░░░██░██░░░░░░ ░░░░░██░░
  24.          ░██       ░██       ░██    ░██░██     ██░██           ░██
  25.          ░█████    ░█████    ░█████████░█████████░█████        ░██
  26.          ░██░░     ░██░░     ░██░░░░██ ░██░░░░██ ░██░░         ░██
  27.          ░██       ░██       ░██   ░░██░██   ░░██░██           ░██
  28.          ░██       ░█████████░██    ░██░██    ░██░█████████    ░██
  29.          ░░        ░░░░░░░░░ ░░     ░░ ░░     ░░ ░░░░░░░░░     ░░
  30.  
  31.  
  32.  
  33.  
  34.                          Ferret V1.00 Reference Manual
  35.              (c) Copyright 1992, 7th Illusion. All rights reserved.
  36.                            Released April 20th, 1992
  37.  
  38.  
  39.                      Documentation written by J.S. Morisset
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.      FERRET V1.00 Reference Manual, (c) Copyright 1992              Page 1
  63.  
  64.  
  65.      Table of Contents
  66.  
  67.      1.  License Agreement . . . . . . . . . . . . . . . . . . . . . . .  2
  68.  
  69.      2.  Disclaimer of Warranty  . . . . . . . . . . . . . . . . . . . .  2
  70.  
  71.      3.  Contacting the Author . . . . . . . . . . . . . . . . . . . . .  2
  72.  
  73.      4.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . . .  3
  74.  
  75.      5.  Configuration . . . . . . . . . . . . . . . . . . . . . . . . .  4
  76.  
  77.          5.1  Ferret.Ctl . . . . . . . . . . . . . . . . . . . . . . . .  4
  78.  
  79.               LogFiles . . . . . . . . . . . . . . . . . . . . . . . . .  4
  80.               Pcbdat . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  81.               Dlpath . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  82.               MstrList . . . . . . . . . . . . . . . . . . . . . . . . .  5
  83.               ExportLst  . . . . . . . . . . . . . . . . . . . . . . . .  6
  84.               ExportFmt  . . . . . . . . . . . . . . . . . . . . . . . .  6
  85.  
  86.          5.2  Password.Ctl . . . . . . . . . . . . . . . . . . . . . . .  7
  87.  
  88.               Flag . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  89.               Address  . . . . . . . . . . . . . . . . . . . . . . . . .  8
  90.               Password . . . . . . . . . . . . . . . . . . . . . . . . .  8
  91.               PCBoard User Name  . . . . . . . . . . . . . . . . . . . .  8
  92.  
  93.      6.  Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  94.  
  95.          6.1  Command Line Switches  . . . . . . . . . . . . . . . . . .  9
  96.  
  97.          6.2  ErrorLevels  . . . . . . . . . . . . . . . . . . . . . . .  9
  98.  
  99.      7.  Revision History  . . . . . . . . . . . . . . . . . . . . . . . 11
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.      
  121.  
  122.      FERRET V1.00 Reference Manual, (c) Copyright 1992              Page 2
  123.  
  124.  
  125.      1.  License Agreement
  126.  
  127.          Ferret is released under the  Shareware concept.  As such, you may
  128.          distribute Ferret freely,  provided you do  not charge copying, or
  129.          any  distribution  fees;  an exception  is  granted  to non-profit
  130.          user's groups, which are  permitted to charge a  small fee (not to
  131.          exceed $5.00 U.S.)  for materials, handling,  postage, and general
  132.          overhead.  No other organization is permitted to charge any amount
  133.          for distribution of copies of the software or documentation, or to
  134.          include  copies of  the software  or  documentation with  sales of
  135.          their  own products.   You  may not  alter,  modify, or  adapt the
  136.          software  or   documentation,  including,   but  not   limited  to
  137.          translating,   decompiling,   reverse   assembling,   or  creating
  138.          derivative works.
  139.  
  140.          You may  use Ferret  free of  charge for  a thirty  day evaluation
  141.          period, after  which you are  expected to  register or discontinue
  142.          using  the  program.   Registration  permits  continued  use  on a
  143.          regular basis on a single computer.  A registered user may use the
  144.          program on a  different computer, but  may not use  the program on
  145.          more than  one computer at  the same  time.  Registration includes
  146.          licensed use of all upgrades.
  147.  
  148.          To  register, send  $15.00 (US  or  CDN) in  check or  money order
  149.          payable to  7th Illusion (no  cash please) at  the mailing address
  150.          listed bellow.
  151.  
  152.      2.  Disclaimer of Warranty
  153.  
  154.          THIS SOFTWARE AND MANUAL ARE  PROVIDED "AS IS" WITHOUT WARRANTY OF
  155.          ANY KIND, EITHER EXPRESSED OR  IMPLIED, INCLUDING, BUT NOT LIMITED
  156.          TO,  THE  IMPLIED  WARRANTIES OF  MERCHANTABILITY  AND  FITNESS OF
  157.          PURPOSE.  THE USER OF THIS  SOFTWARE AND MANUAL ASSUMES ALL RISKS.
  158.          SHOULD FERRET OR ITS ASSOCIATED DOCUMENTATION PROVE DEFECTIVE, YOU
  159.          ASSUME  THE   COSTS  OF   ALL  NECESSARY   SERVICING,  REPAIR,  OR
  160.          CORRECTION.
  161.  
  162.      3.  Contacting the Author
  163.  
  164.          Netmail and/or E-Mail
  165.  
  166.          Fidonet       1:167/281
  167.          Internet      storm.widow@f281.n167.z1.fidonet.org
  168.          Compuserve    >INTERNET:storm.widow@f281.n167.z1.fidonet.org
  169.          BBS           (514) 338-1193, 14400 HST
  170.                        (514) 338-1680, 2400 Generic
  171.  
  172.          Surface Mail
  173.  
  174.                         7th Illusion
  175.                         Post Office Box 1334, Station H
  176.                         Montreal QC, Canada
  177.                         H3G 2N6
  178.  
  179.  
  180.      
  181.  
  182.      FERRET V1.00 Reference Manual, (c) Copyright 1992              Page 3
  183.  
  184.  
  185.      4.  Introduction
  186.  
  187.          I have written this manual with the assumption that readers have a
  188.          basic  understanding  of  fidonet technology.   If  any  terms are
  189.          unclear, you  should review  the documentation  supplied with your
  190.          front-end mailer.  SysOps with point setups will find this program
  191.          especially useful in controlling and accounting for file requests.
  192.  
  193.          Ferret enables  System Operators  using PCBoard  with BinkleyTerm,
  194.          and/or  FrontDoor,  to  credit callers  for  their  File Requests.
  195.          Session passwords may be  assigned and removed automatically based
  196.          on several criteria, including  security level.  You can therefore
  197.          control F'Req  privileges just as  you would  control downloads on
  198.          your BBS.
  199.  
  200.          With a  minimum of configuration,  Ferret can  be installed within
  201.          minutes.  Multi-node installations require little more hassle than
  202.          a single line BBS.
  203.  
  204.          Examples herein are shown for standard BinkleyTerm setups.  If you
  205.          are using FrontDoor, I  would appreciate any comments illustrating
  206.          the differences.
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.      
  241.  
  242.      FERRET V1.00 Reference Manual, (c) Copyright 1992              Page 4
  243.  
  244.  
  245.      5.  Configuration
  246.  
  247.          Included within this  archive are two  sample configuration files,
  248.          herein  after  referred  to  as  'control  files'.   The following
  249.          sections show the configuration of  each.  Please read section 3.2
  250.          on password  assignment carefully,  as this  is the  most flexible
  251.          feature of Ferret.
  252.  
  253.          5.1  Ferret.Ctl
  254.  
  255.               Each configuration item  is controlled by  a leading keyword.
  256.               Values may be in upper, or  lower case, and must be separated
  257.               with at least one space.  Semi-colons are used to comment out
  258.               a line of text.
  259.  
  260.          LogFiles
  261.  
  262.               Following   this   keyword,  you   must   enter   a  complete
  263.               path/filename to  your front-end  log file,  and report file.
  264.               You  may use  a  maximum of  128  entries with  this keyword,
  265.               making  multi-node configurations  possible.  Entries  to the
  266.               report  file reflect  record adjustments,  request filenames,
  267.               and  totals.  It  is suggested  you  review this  report file
  268.               before deleting it.
  269.  
  270.               Example:
  271.  
  272.               logfiles  d:\bt0\log\bt1.log  d:\matrix\ferret\ferret.rpt
  273.               logfiles  d:\bt0\log\bt2.log  d:\matrix\ferret\ferret.rpt
  274.               .
  275.               .
  276.               .
  277.               logfiles  d:\bt0\log\bt100.log  d:\matrix\ferret\private.rpt
  278.  
  279.               Notice  that one  or  more report  files  may share  the same
  280.               filename.
  281.  
  282.          Pcbdat
  283.  
  284.               Enter the complete path/filename  to your primary PCBoard.dat
  285.               file.  Ferret  will use  Pcboard's data  file to  gather path
  286.               information on your userfile,  index files, fsec, and minimum
  287.               download security level.
  288.  
  289.               Example:
  290.  
  291.               pcbdat    d:\pcb0\pcboard.dat
  292.  
  293.          DlPath
  294.  
  295.               Complete path/filename of download path list file.  This file
  296.               is identical  to Pcboard's dlpath.lst  file.  In  fact, it is
  297.               expected  you  use  the   same  one  specified  in  Pcboard's
  298.               configuration.  Paths listed within this file are entered one
  299.  
  300.      
  301.  
  302.      FERRET V1.00 Reference Manual, (c) Copyright 1992              Page 5
  303.  
  304.  
  305.               per line.
  306.  
  307.               Example:
  308.  
  309.               F:\Main\Up\
  310.               F:\Main\DiskFile\
  311.               .
  312.               .
  313.               .
  314.               F:\Main\DiagUtil\
  315.  
  316.               PCBoard  offers  an extra  feature,  called  dlpath indexing.
  317.               These index filenames  are entered in  your dlpath.lst with a
  318.               leading percent sign.
  319.  
  320.               Example:
  321.  
  322.               F:\Main\Up\
  323.               F:\Main\DiskFile\
  324.               .
  325.               .
  326.               .
  327.               %F:\Cd-Rom.Idx
  328.  
  329.               Ferret does NOT need, or  use these index files.  Ferret only
  330.               uses  path information  to recognize  files belonging  to the
  331.               BBS.   If you  use index  files,  create another  dlpath file
  332.               expressly for Ferret.
  333.  
  334.               Example:
  335.  
  336.               dlpath    e:\locl\main\dirs\dlpath.lst
  337.               .
  338.               .
  339.               .
  340.               dlpath    e:\locl\alde\dirs\cd-rom.lst
  341.  
  342.               Note; there is a limit of 128 possible dlpath keywords.
  343.  
  344.               Ferret  also   supports  the   practice  of   assigning  FREE
  345.               downloads.  After scanning your download paths, and finding a
  346.               match, Ferret  will investigate  your fsec  file for possible
  347.               exceptions.  Your fsec contains path, filename, security, and
  348.               password information.  Ferret ignores security, and any other
  349.               password than 'FREE'.
  350.  
  351.          MstrList
  352.  
  353.               Master password control path and filename.  It is referred to
  354.               as the 'Master' password file  since it's values are exported
  355.               to other text  files.  Nodelist compilers  would then use the
  356.               exported information  to assign session  passwords within the
  357.               nodelist.
  358.  
  359.  
  360.      
  361.  
  362.      FERRET V1.00 Reference Manual, (c) Copyright 1992              Page 6
  363.  
  364.  
  365.               Example:
  366.  
  367.               mstrlist  d:\matrix\ferret\password.ctl
  368.  
  369.          ExportLst
  370.  
  371.               Path/filename  used  to  export  nodelist  information.   ie:
  372.               address, password,  etc.  The  format this  information takes
  373.               may be configured with the exportfmt keyword.
  374.  
  375.               Example:
  376.  
  377.               exportlst d:\matrix\nodelist\xlaxnode.pwd
  378.  
  379.               In the  case of  XlaxNode, one  of the  more popular nodelist
  380.               compilers,  this  external password  file  also  specified in
  381.               XlaxNode's control file.
  382.  
  383.               Example:
  384.  
  385.               Node           1:167/281
  386.               SortWork       H:\
  387.               Buffers        6
  388.               MyList         Points.Lst
  389.               Progress
  390.               NoForceScan
  391.               Update         XlaxDiff.Exe /C /E=D:\Matrix\Nodediff\Nodediff
  392.               AllZones
  393.               PasswordFile   XlaxNode.Pwd
  394.               ;              ^^^^^^^^^^^^
  395.               Comments       Nodelist.Cmt
  396.               Report
  397.               Version7       Userlist
  398.               .
  399.               .
  400.               .
  401.  
  402.          ExportFmt
  403.  
  404.               Each node listed  in the Master  list may be  exported to the
  405.               external password file, outlined above.  The format which the
  406.               exported  information takes  is  controlled by  three macros;
  407.               @address@,  @password@,  and  @name@.   Other  values  may be
  408.               included and would be transferred relative to the macros.
  409.  
  410.               Example:
  411.  
  412.               ; XlaxNode's password file format
  413.               ;
  414.               exportfmt @address@ @password@
  415.  
  416.               ; Imaginary sample with leading keyword and trailing flags
  417.               ;
  418.               exportfmt Password @address@ @password@ F:N A:Y L:2
  419.  
  420.      
  421.  
  422.      FERRET V1.00 Reference Manual, (c) Copyright 1992              Page 7
  423.  
  424.  
  425.          5.2  Password.Ctl - Master List
  426.  
  427.          Flag
  428.  
  429.               %    Export  user information  if  his access  is  higher, or
  430.                    equal,   to  the   d/l   security  level   specified  in
  431.                    PCBoard.Dat.   This  flag would  be  useful  for systems
  432.                    adjusting user  levels, and  want to  cut a  node's file
  433.                    request privileges when his access drops too low.
  434.  
  435.               #    Instructs  Ferret  to  ignore   a  users  access  level.
  436.                    Although, the  user _must_  have an  record in  the user
  437.                    file, otherwise his information is not exported.
  438.  
  439.               *    Always export  information.  The users  access level, or
  440.                    whether he has  a record in  the userfile is irrelevant.
  441.                    I  would  suggest  this  flag  for  fidonet  nodes.  You
  442.                    wouldn't  want to  compromise  security for  netmail and
  443.                    echomail transfers.
  444.  
  445.               These flags control the exporting of information for nodelist
  446.               compilers only.  All listed users  will be credited for their
  447.               downloads regardless (providing they have a userfile record).
  448.  
  449.               BinkleyTerm  users can  control  F'Reqs with  a  three tiered
  450.               configuration.   As   the  following   example  shows,  three
  451.               different   'Okfile'   statements   are   used.    The   last
  452.               'ProtReqList' makes  all BBS  archives accessible  to systems
  453.               with  passwords.  'KnownReqList'  would  _not_ list  BBS file
  454.               paths.   Using the  '%' flag,  you  can therefore  remove BBS
  455.               archive privileges from users  who's level has dropped bellow
  456.               the download command security.
  457.  
  458.               Example:
  459.  
  460.               .
  461.               .
  462.               .
  463.               ReqOnUs
  464.               MaxReq         3
  465.               MaxTime        30
  466.               MaxBytes       100000
  467.               Okfile         D:\Matrix\Freq\NormlReq.Lst
  468.               Avail          D:\Matrix\Freq\f167_281.Lst
  469.               About          D:\Matrix\Freq\About281.Txt
  470.               ReqTemplate    D:\Matrix\Freq\Bad_Freq.Tpl
  471.               ;
  472.               KnownReqLim    5
  473.               KnownMaxTime   45
  474.               KnownMaxBytes  200000
  475.               KnownReqList   D:\Matrix\Freq\KnownReq.Lst
  476.               ;
  477.               ProtReqLim     10
  478.               ProtMaxTime    60
  479.  
  480.      
  481.  
  482.      FERRET V1.00 Reference Manual, (c) Copyright 1992              Page 8
  483.  
  484.  
  485.               ProtMaxBytes   500000
  486.               ProtReqList    D:\Matrix\Freq\ProtdReq.Lst
  487.               .
  488.               .
  489.               .
  490.  
  491.          Address
  492.  
  493.               Network address used  by remote system.   This address may be
  494.               as  complete as  you wish.   Ferret will  recognize different
  495.               domains,   zones,  etc.   provided   you  enter   the  proper
  496.               information.
  497.  
  498.               Example:
  499.  
  500.               167/281
  501.               1:167/281
  502.               1:167/281.10
  503.               1:167/281@fidonet.org
  504.               1:167/281.10@fidonet.org
  505.  
  506.          Password
  507.  
  508.               Session password compiled in nodelist (max. 8 chars).
  509.  
  510.          PCBoard User Name
  511.  
  512.               Name used  in pcboard user  file (max. 25  chars).  No matter
  513.               what flag you assign a  node, Ferret will always credit users
  514.               for their file requests.  Provided  they have a record in the
  515.               userfile, of course.
  516.  
  517.          Example:
  518.  
  519.          Fl Address            Password PCBoard User Name
  520.          -- ------------------ -------- ------------------
  521.          *  1:167/0            xxxxxxxx Steve Monteith
  522.          *  1:167/90           xxxxxxxx Renald Loignon
  523.          *  1:167/121          xxxxxxxx Andre Coulombe
  524.          *  1:167/133          xxxxxxxx Steve Monteith
  525.          *  1:167/141          xxxxxxxx Denis Grenier
  526.          *  1:167/166          xxxxxxxx Shawn O'Connor
  527.          *  1:167/176          xxxxxxxx Renald Loignon
  528.          *  1:167/179          xxxxxxxx Sylvain Aube
  529.          *  1:167/208          xxxxxxxx Alex Muprhy
  530.          *  1:167/237          xxxxxxxx Frederic Hutow
  531.          *  1:167/620          xxxxxxxx Steven Dworzak
  532.  
  533.          ;  Bellow are point addresses.  Session passwords are not assigned
  534.          ;  if their security level would disallow downloads on the BBS.
  535.  
  536.          %  1:167/281.100      xxxxxxxx Matt Pugliese
  537.          %  1:167/281.110      xxxxxxxx Steve Greenspon
  538.  
  539.  
  540.      
  541.  
  542.      FERRET V1.00 Reference Manual, (c) Copyright 1992              Page 9
  543.  
  544.  
  545.      6.  Usage
  546.  
  547.          To execute  Ferret, simply enter  it's name followed  by a command
  548.          line switch, and the control  path/filename.  You should _not_ run
  549.          Ferret while PCBoard  and/or your front-end  mailer is loaded.  If
  550.          you have  a midnight maintenance  run where all  nodes are downed,
  551.          this would be an ideal occasion to execute Ferret.
  552.  
  553.          Example:
  554.  
  555.          D:\FERRET>Ferret.Exe /cFerret.Ctl
  556.  
  557.          After running Ferret, you should delete or rename the log files of
  558.          your front-end mailer.
  559.  
  560.          Example:
  561.  
  562.          .
  563.          .
  564.          .
  565.          Rem /// Begin Ferret Execution
  566.  
  567.          D:
  568.          Cd\Matrix\Ferret
  569.          Ferret /cFerret.Ctl
  570.  
  571.          Rem /// Keep BinkleyTerm log file backups.
  572.  
  573.          D:
  574.          Cd\Bt0\Log
  575.          DayNbr.Com If Exist Bt*.Log Ren Bt*.Log Bt*.@###
  576.  
  577.          Rem /// Kill log files older than 3 days.
  578.  
  579.          Dk.Exe /D;3/F;Bt*.*
  580.          .
  581.          .
  582.          .
  583.  
  584.          6.1  Command Line Switches
  585.  
  586.               Command line  arguments are  preceded by  a forward  slash, a
  587.               switch  character,  and  it's  value.   Only  one  switch  is
  588.               currently available.
  589.  
  590.               C    Configuration file name and path.
  591.  
  592.          6.2  ErrorLevels
  593.  
  594.               Ferret should always exit with an errorlevel of zero.  If you
  595.               attempt to execute Ferret while PCBoard and/or your mailer is
  596.               running, it will  most definitely exit with  one of the error
  597.               codes bellow.
  598.  
  599.  
  600.      
  601.  
  602.      FERRET V1.00 Reference Manual, (c) Copyright 1992              Page 10
  603.  
  604.  
  605.               (5)  Error writing to file.
  606.  
  607.               (4)  Error reading from file.
  608.  
  609.               (3)  Unexpected EOF or out-of-sync.
  610.  
  611.                    PCBNDX  files  do  not   match  your  user  file.   Load
  612.                    PCBoard's System Manager and re-create the index files.
  613.  
  614.               (2)  Array bounds exceeded.
  615.  
  616.                    Too  many  'LogFiles'  or  'DlPath'  keywords  have been
  617.                    entered in Ferret's control file.
  618.  
  619.               (1)  Error opening file.
  620.  
  621.                    You  have specified  and incorrect  path or  filename in
  622.                    Ferret's control file.
  623.  
  624.               (0)  Default.
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.      
  661.  
  662.      FERRET V1.00 Reference Manual, (c) Copyright 1992              Page 11
  663.  
  664.  
  665.      7.  Revision History
  666.  
  667.                                     Version 1.00
  668.                              Released April 20th, 1992
  669.  
  670.          Initial release.
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.      
  721.